home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_xemacs.idb / usr / freeware / lib / xemacs-20.4 / info / gnus-mime-en.info.z / gnus-mime-en.info
Encoding:
GNU Info File  |  1998-05-21  |  12.2 KB  |  345 lines
  1. This is Info file ../../info/gnus-mime-en.info, produced by Makeinfo
  2. version 1.68 from the input file gnus-mime-en.texi.
  3.  
  4. 
  5. File: gnus-mime-en.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
  6.  
  7. gnus-mime 0.10 reference manual (English Version)
  8. *************************************************
  9.  
  10.    This file documents gnus-mime, a MIME extension for Gnus.
  11.  
  12. * Menu:
  13.  
  14. * Introduction::                What is gnus-mime?
  15. * Automatic MIME Preview::      Inline display for MIME message
  16. * mule::                        Internationalization
  17. * MIME-Edit::                   Composing MIME messages
  18. * Concept Index::
  19. * Function Index::
  20. * Variable Index::
  21.  
  22. 
  23. File: gnus-mime-en.info,  Node: Introduction,  Next: Automatic MIME Preview,  Prev: Top,  Up: Top
  24.  
  25. What is gnus-mime?
  26. ******************
  27.  
  28.    *gnus-mime* is a MIME (*Note (tm-en)MIME::) extender for Gnus (*Note
  29. (gnus)::) using tm (*Note (tm-en)tm-kernel::).
  30.  
  31. *[Notice]*
  32.      gnus-mime is for only Gnus.  Please use tm-gnus (*Note
  33.      (tm-gnus_en)::) for GNUS.
  34.  
  35.    gnus-mime supports automatic MIME preview in `"*Article*"' buffer
  36. using tm-view (*Note (tm-view-en)::).  In particular, with XEmacs, it
  37. decodes images as same as text.
  38.  
  39.    In addition, gnus-mime supports multilingual/internationalization
  40. feature for mule such as MULE (*Note (tm-en)mule::), XEmacs/mule and
  41. mule merged Emacs.  It supports code-conversion by MIME charset or
  42. depended default MIME charset of newsgroups.
  43.  
  44.    For RFC 1522, original Gnus supports only Q-encoded iso-8859-1
  45. (*Note (tm-en)iso-8859-1::) encoded-word (*Note (tm-en)encoded-word::).
  46. So gnus-mime supports more MIME charsets, such as iso-8859-2 (*Note
  47. (tm-en)iso-8859-2::), iso-8859-3 (*Note (tm-en)iso-8859-3::), ...,
  48. iso-2022-jp (*Note (tm-en)iso-2022-jp::), euc-kr (*Note
  49. (tm-en)euc-kr::), iso-2022-kr (*Note (tm-en)iso-2022-kr::), gb2312,
  50. hz-gb-2312 (*Note (tm-en)hz-gb-2312::), cn-big5 (*Note
  51. (tm-en)cn-big5::), and B-encoding.  In addition, original Gnus does not
  52. support unfolding or space elimination rule of RFC 1522.  gnus-mime is
  53. more rightful.
  54.  
  55. 
  56. File: gnus-mime-en.info,  Node: Automatic MIME Preview,  Next: mule,  Prev: Introduction,  Up: Top
  57.  
  58. Inline display for MIME message
  59. *******************************
  60.  
  61.    *automatic MIME preview* feature is available for gnus-mime.  In
  62. automatic MIME preview mode, when reading an article in summary mode,
  63. gnus-mime displays preview buffer processed by tm-view instead of raw
  64. article buffer. (cf. *Note (tm-view-en)::)
  65.  
  66.    Therefore if an article is encoded by Base64 (*Note (tm-en)Base64::)
  67. or Quoted-Printable (*Note (tm-en)Quoted-Printable::), a decoded
  68. article is displayed.  Or rich text article, such as text/enriched
  69. (*Note (tm-en)text/enriched::) format, is automatic formated.  Of
  70. course, multipart (*Note (tm-en)multipart::) article is dealt with
  71. correctly.
  72.  
  73.    In addition, in *XEmacs*, images are displayed in preview buffer as
  74. same as text.
  75.  
  76.    Different from using metamail, speaker does not roar just then read
  77. an article includes audio content, video player does not play just then
  78. read an article includes video content, it does not do anonymous ftp
  79. (*Note (tm-en)ftp::) or send mail when read an article includes
  80. external-message.  These contents are played when you do decoding
  81. command in preview buffer.
  82.  
  83.    However if you use a slow machine, or are just really impatient, you
  84. can stop automatic MIME preview.
  85.  
  86. * Menu:
  87.  
  88. * MIME processing::             How to process MIME in Article Buffer
  89. * Two buffers for an article::  Mechanism of Automatic MIME preview
  90.  
  91. 
  92. File: gnus-mime-en.info,  Node: MIME processing,  Next: Two buffers for an article,  Prev: Automatic MIME Preview,  Up: Automatic MIME Preview
  93.  
  94. How to process MIME in Article Buffer
  95. =====================================
  96.  
  97.    When `gnus-show-mime' is not `nil' and an article has Mime-Version
  98. field in its message header, namely it is a MIME message, Gnus calls
  99. `gnus-show-mime-method' to process MIME.
  100.  
  101.    When `gnus-strict-mime' is `nil' and `gnus-show-mime' is not `nil',
  102. Gnus calls `gnus-show-mime-method' even if an message does not have
  103. Mime-Version field in its message header.
  104.  
  105.    Gnus 5.2 or later calls `gnus-show-mime-method' when
  106. `gnus-strict-mime' is not `nil' and an article does not have
  107. Mime-Version field.  Notice that old Gnus does not have it, so it may
  108. be better to set `gnus-strict-mime' to `nil'.
  109.  
  110.  - Variable: gnus-show-mime
  111.      If it is not `nil', Gnus do automatic MIME preview.  Default value
  112.      is `t'.
  113.  
  114.      It is a variable of Gnus, so if gnus is loaded before gnus-mime is
  115.      loaded, default value is not guaranteed.
  116.  
  117.      (cf. *Note (gnus)Using MIME::)
  118.  
  119.  - Variable: gnus-show-mime-method
  120.      Gnus calls function bound by it to process MIME.  Default value is
  121.      `gnus-article-preview-mime-message'.
  122.  
  123.      It is a variable of Gnus, so if gnus is loaded before gnus-mime is
  124.      loaded, default value is not guaranteed.
  125.  
  126.      (cf. *Note (gnus)Using MIME::)
  127.  
  128.  - Variable: gnus-decode-encoded-word-method
  129.      Gnus calls function bound by it to decode encoded-words.  Default
  130.      value is `gnus-article-decode-encoded-word'.
  131.  
  132.      It is a variable of Gnus, so if gnus is loaded before gnus-mime is
  133.      loaded, default value is not guaranteed.
  134.  
  135.      In addition, it is not available at Gnus 5.0.* or Gnus 5.1.
  136.  
  137. *[Notice]*
  138.      gnus-mime uses some variables of Gnus and defines different default
  139.      values by `defvar'.  For example, gnus-mime's default value of
  140.      `gnus-show-mime' is `t' instead of `nil'.  Or its default value of
  141.      `gnus-show-mime-method' is `gnus-article-preview-mime-message'
  142.      instead of `metamail-buffer'.  (cf. *Note (gnus)Using MIME::)
  143.  
  144.      gnus-mime uses `defvar' instead of `setq', because of respect
  145.      user's setting before gnus-mime is loaded, such as using
  146.      `~/.emacs'.  But it has a problem.  If gnus is loaded before
  147.      gnus-mime is loaded, features of gnus-mime is not available in
  148.      default even if gnus-mime is loaded.  Therefore there is serious
  149.      problem to load gnus before gnus-mime is loaded.  In other words,
  150.      setting in `~/.gnus', such as to load `gnus-mime' or `mime-setup',
  151.      is not good way.  If you want such way, please do setting for
  152.      `gnus-show-mime' and `gnus-show-mime-method'.
  153.  
  154. 
  155. File: gnus-mime-en.info,  Node: Two buffers for an article,  Prev: MIME processing,  Up: Automatic MIME Preview
  156.  
  157. Mechanism of Automatic MIME preview
  158. ===================================
  159.  
  160.    Gnus 5.2 or later has two buffers for an article,
  161. `gnus-original-article-buffer' (`" *Original Article*"') and
  162. `gnus-article-buffer' (`"*Article*"').  The former is called *raw
  163. article buffer*, the latter is called *preview buffer*.
  164.  
  165.    Content of raw article buffer is non-processed "raw message".  In
  166. particular, for emacs variants includes mule (*Note (tm-en)mule::)
  167. features, message is not code-converted in it.
  168.  
  169.    Content of preview buffer is MIME processed message to display for
  170. user.  In particular, for emacs variants includes mule features,
  171. non-ASCII message is code-converted in it by MIME charset or default
  172. MIME charset (*Note (tm-en)MIME charset::) for selected newsgroup.
  173.  
  174.    Gnus 5.0.* and Gnus 5.1 don't have distinction between raw article
  175. buffer and preview buffer.  So gnus-mime emulate raw article buffer.  It
  176. is unnatural, so it may be better to use Gnus 5.2 or later, which are
  177. designed for tm-view.
  178.  
  179.    (cf. *Note (tm-view-en)Two buffers for an article::)
  180.  
  181. 
  182. File: gnus-mime-en.info,  Node: mule,  Next: MIME-Edit,  Prev: Automatic MIME Preview,  Up: Top
  183.  
  184. Internationalization
  185. ********************
  186.  
  187.    For emacs variants includes mule feature, such as MULE (*Note
  188. (tm-en)MULE::), XEmacs/mule and Emacs/mule(*1), gnus-mime supports
  189. code-conversion by MIME charset (*Note (tm-en)MIME charset::) or
  190. `default-mime-charset' of selected newsgroup.
  191.  
  192. *[Memo]*
  193.      (*1) It means next generation of Emacs includes mule features.  Now
  194.      (October 1996), HANDA Ken'ichi and RMS are developing it.
  195.  
  196.    Detail of code conversion is following:
  197.  
  198.   1. If a newsgroup is selected, MIME charset for the newsgroup is
  199.      searched from `gnus-newsgroup-default-charset-alist'.  If it is
  200.      found, it is set to buffer local variable `default-mime-charset'
  201.      of Summary Buffer.  If not found, global value of
  202.      `default-mime-charset' is used.
  203.  
  204.   2. Non-ASCII characters in Summary Buffer are code-converted by
  205.      `default-mime-charset' in Summary Buffer.
  206.  
  207.   3. encoded-word (*Note (tm-en)encoded-word::) are code-converted by
  208.      their specified MIME charset (*Note (tm-en)MIME charset::).
  209.  
  210.   4. Code-conversion of articles are following:
  211.  
  212.        1. If a part of a MIME message has charset parameter of
  213.           Content-Type field (*Note (tm-en)Content-Type field::), it is
  214.           code-converted by the MIME charset.
  215.  
  216.        2. When there are no specified MIME charset, such as message
  217.           header or non-MIME message, they are code-converted by
  218.           `default-mime-charset' in Summary Buffer.
  219.  
  220.  - Variable: gnus-newsgroup-default-charset-alist
  221.      Association-list regexp for newsgroup vs. symbol for default MIME
  222.      charset.
  223.  
  224.      Default setting are following:
  225.  
  226.     `alt.chinese.*'
  227.           hz-gb-2312 (*Note (tm-en)hz-gb-2312::)
  228.  
  229.     `alt.chinese.text.big5, hk.*, hkstar.*, tw.*'
  230.           cn-big5 (*Note (tm-en)cn-big5::)
  231.  
  232.     `fj.*'
  233.           iso-2022-jp-2 (*Note (tm-en)iso-2022-jp-2::)
  234.  
  235.     `han.*'
  236.           euc-kr (*Note (tm-en)euc-kr::)
  237.  
  238.     `relcom.*'
  239.           koi8-r (*Note (tm-en)koi8-r::)
  240.  
  241.      If there is no MIME charsets for a newsgroup,
  242.      `default-mime-charset' is used as default MIME charset.
  243.  
  244.  - Function: gnus-set-newsgroup-default-charsetnewsgroup CHARSET
  245.      Set default MIME CHARSET of NEWSGROUP to
  246.      `gnus-newsgroup-default-charset-alist'.
  247.  
  248.      NEWSGROUP is string of newsgroup name or category, for
  249.      `"gnu.emacs.gnus"', `"gnu.emacs"', `"gnu"'.
  250.  
  251.      CHARSET is symbol of MIME charset, for example `iso-8859-1',
  252.      `iso-2022-jp'.
  253.  
  254. 
  255. File: gnus-mime-en.info,  Node: MIME-Edit,  Next: Concept Index,  Prev: mule,  Up: Top
  256.  
  257. Composing MIME messages
  258. ***********************
  259.  
  260.    If using mime-setup (*Note (tm-en)mime-setup::), you can edit MIME
  261. message in message-mode using tm-edit (*Note (tm-edit-en)::).
  262.  
  263. *[Notice]*
  264.      Default setting of mime-setup avoids automatic inserting signature
  265.      when sending a message.
  266.  
  267.      (cf. *Note (tm-en)mime-setup::)
  268.  
  269.    gnus-mime does not have implementation for `C-c C-x C-m'
  270. (`mime-editor/insert-mail').  Because gnus-mime does not know which
  271. mail-reader should be used.  In addition, `C-c C-x C-y'
  272. (`mime-editor/insert-message') is enough to insert mail (namely to
  273. select a mail group and select a message to insert, then it is available
  274. to insert the mail message).
  275.  
  276.    However you can use `C-c C-x C-m' to specify an implementation of
  277. `message-mode' to `mime-editor/mail-inserter-alist'.
  278.  
  279. Example: same as `C-c C-x C-m'
  280. ==============================
  281.  
  282.      (set-alist 'mime-editor/mail-inserter-alist
  283.             'message-mode (function message-mime-insert-article))
  284.  
  285. Example: including from MH folder
  286. =================================
  287.  
  288.      (autoload 'tm-mh-e/insert-mail "tm-mh-e")
  289.      
  290.      (set-alist 'mime-editor/mail-inserter-alist
  291.             'message-mode (function tm-mh-e/insert-mail))
  292.  
  293. 
  294. File: gnus-mime-en.info,  Node: Concept Index,  Next: Function Index,  Prev: MIME-Edit,  Up: Top
  295.  
  296. Concept Index
  297. *************
  298.  
  299. * Menu:
  300.  
  301. * automatic MIME preview:                Automatic MIME Preview.
  302. * gnus-mime:                             Introduction.
  303. * preview buffer:                        Two buffers for an article.
  304. * raw article buffer:                    Two buffers for an article.
  305. * XEmacs:                                Automatic MIME Preview.
  306.  
  307. 
  308. File: gnus-mime-en.info,  Node: Function Index,  Next: Variable Index,  Prev: Concept Index,  Up: Top
  309.  
  310. Function Index
  311. **************
  312.  
  313. * Menu:
  314.  
  315. * gnus-set-newsgroup-default-charsetnewsgroup: mule.
  316.  
  317. 
  318. File: gnus-mime-en.info,  Node: Variable Index,  Prev: Function Index,  Up: Top
  319.  
  320. Variable Index
  321. **************
  322.  
  323. * Menu:
  324.  
  325. * gnus-decode-encoded-word-method:       MIME processing.
  326. * gnus-newsgroup-default-charset-alist:  mule.
  327. * gnus-show-mime:                        MIME processing.
  328. * gnus-show-mime-method:                 MIME processing.
  329.  
  330.  
  331. 
  332. Tag Table:
  333. Node: Top122
  334. Node: Introduction661
  335. Node: Automatic MIME Preview2058
  336. Node: MIME processing3536
  337. Node: Two buffers for an article6239
  338. Node: mule7413
  339. Node: MIME-Edit9937
  340. Node: Concept Index11240
  341. Node: Function Index11702
  342. Node: Variable Index11901
  343. 
  344. End Tag Table
  345.